package com.coursehub.user.service;

import com.coursehub.user.dto.UserDTO;
import com.coursehub.user.entity.User;

import java.util.List;
import java.util.Optional;

/**
 * 用户服务接口
 * 
 * @author CourseHub Team
 */
public interface UserService {
    
    /**
     * 用户注册
     * @param user 用户对象
     * @return 注册后的用户对象
     */
    User registerUser(User user);
    
    /**
     * 用户登录验证
     * @param username 用户名
     * @param password 密码
     * @return 用户对象（如果验证成功）
     */
    Optional<User> authenticateUser(String username, String password);
    
    /**
     * 根据ID查找用户
     * @param id 用户ID
     * @return 用户DTO
     */
    Optional<UserDTO> findUserById(String id);
    
    /**
     * 根据用户名查找用户
     * @param username 用户名
     * @return 用户DTO
     */
    Optional<UserDTO> findUserByUsername(String username);
    
    /**
     * 根据邮箱查找用户
     * @param email 邮箱
     * @return 用户DTO
     */
    Optional<UserDTO> findUserByEmail(String email);
    
    /**
     * 获取所有用户
     * @return 用户DTO列表
     */
    List<UserDTO> getAllUsers();
    
    /**
     * 根据角色获取用户列表
     * @param role 角色
     * @return 用户DTO列表
     */
    List<UserDTO> getUsersByRole(String role);
    
    /**
     * 更新用户信息
     * @param id 用户ID
     * @param userDTO 用户DTO
     * @return 更新后的用户DTO
     */
    Optional<UserDTO> updateUser(String id, UserDTO userDTO);
    
    /**
     * 删除用户
     * @param id 用户ID
     * @return 是否删除成功
     */
    boolean deleteUser(String id);
    
    /**
     * 切换用户状态
     * @param id 用户ID
     * @param isActive 是否激活
     * @return 是否操作成功
     */
    boolean toggleUserStatus(String id, boolean isActive);
    
    /**
     * 检查用户名是否存在
     * @param username 用户名
     * @return 是否存在
     */
    boolean existsByUsername(String username);
    
    /**
     * 检查邮箱是否存在
     * @param email 邮箱
     * @return 是否存在
     */
    boolean existsByEmail(String email);
    
    /**
     * 根据用户名模糊查询
     * @param username 用户名关键字
     * @return 用户DTO列表
     */
    List<UserDTO> searchUsersByUsername(String username);
    
    /**
     * 统计指定角色的活跃用户数量
     * @param role 角色
     * @return 用户数量
     */
    long countActiveUsersByRole(String role);
}